Inside Macintosh: QuickTime Components /

Chapter 6 - Sequence Grabber Channel Components / Sequence Grabber Channel Components Reference

Functions / Configuring Sequence Grabber Channel Components

SGInitChannel

A sequence grabber component calls the SGInitChannel function to initialize a sequence grabber channel component. Your component should perform its initialization processing here, rather than in response to the Component Manager's open request. The initialization processing may include allocating memory or checking for the availability of special-purpose hardware or software.

pascal ComponentResult SGInitChannel (SGChannel c, 
                                       SeqGrabComponent owner);

c

Identifies the channel connection for this operation.

owner

Identifies the sequence grabber component that has connected to your channel component. You should save this value so that your channel component can call the utility functions that are provided by the sequence grabber component (see "Utility Functions for Sequence Grabber Channel Components," which begins on page 6-81, for information about these utility functions).

DESCRIPTION

If your component cannot gain access to the resources or equipment it needs to function properly, you should return a nonzero result code. If you return a nonzero result, the sequence grabber component closes its connection to your component and reports the error to the calling application.

RESULT CODES

noDeviceForChannel

-9400

Channel component cannot find its device

File Manager errors
Memory Manager errors

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help